home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / zlascl.z / zlascl
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. ZZZZLLLLAAAASSSSCCCCLLLL((((3333FFFF))))                                                          ZZZZLLLLAAAASSSSCCCCLLLL((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ZLASCL - multiplie the M by N complex matrix A by the real scalar
  10.      CTO/CFROM
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE ZLASCL( TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO )
  14.  
  15.          CHARACTER      TYPE
  16.  
  17.          INTEGER        INFO, KL, KU, LDA, M, N
  18.  
  19.          DOUBLE         PRECISION CFROM, CTO
  20.  
  21.          COMPLEX*16     A( LDA, * )
  22.  
  23. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  24.      ZLASCL multiplies the M by N complex matrix A by the real scalar
  25.      CTO/CFROM.  This is done without over/underflow as long as the final
  26.      result CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that A
  27.      may be full, upper triangular, lower triangular, upper Hessenberg, or
  28.      banded.
  29.  
  30.  
  31. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  32.      TYPE    (input) CHARACTER*1
  33.              TYPE indices the storage type of the input matrix.  = 'G':  A is
  34.              a full matrix.
  35.              = 'L':  A is a lower triangular matrix.
  36.              = 'U':  A is an upper triangular matrix.
  37.              = 'H':  A is an upper Hessenberg matrix.
  38.              = 'B':  A is a symmetric band matrix with lower bandwidth KL and
  39.              upper bandwidth KU and with the only the lower half stored.  =
  40.              'Q':  A is a symmetric band matrix with lower bandwidth KL and
  41.              upper bandwidth KU and with the only the upper half stored.  =
  42.              'Z':  A is a band matrix with lower bandwidth KL and upper
  43.              bandwidth KU.
  44.  
  45.      KL      (input) INTEGER
  46.              The lower bandwidth of A.  Referenced only if TYPE = 'B',
  47.  
  48.      KU      (input) INTEGER
  49.              The upper bandwidth of A.  Referenced only if TYPE = 'B',
  50.  
  51.      CFROM   (input) DOUBLE PRECISION
  52.              CTO     (input) DOUBLE PRECISION The matrix A is multiplied by
  53.              CTO/CFROM. A(I,J) is computed without over/underflow if the final
  54.              result CTO*A(I,J)/CFROM can be represented without
  55.              over/underflow.  CFROM must be nonzero.
  56.  
  57.      M       (input) INTEGER
  58.              The number of rows of the matrix A.  M >= 0.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZZZZLLLLAAAASSSSCCCCLLLL((((3333FFFF))))                                                          ZZZZLLLLAAAASSSSCCCCLLLL((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      N       (input) INTEGER
  75.              The number of columns of the matrix A.  N >= 0.
  76.  
  77.      A       (input/output) COMPLEX*16 array, dimension (LDA,M)
  78.              The matrix to be multiplied by CTO/CFROM.  See TYPE for the
  79.              storage type.
  80.  
  81.      LDA     (input) INTEGER
  82.              The leading dimension of the array A.  LDA >= max(1,M).
  83.  
  84.      INFO    (output) INTEGER
  85.              0  - successful exit <0 - if INFO = -i, the i-th argument had an
  86.              illegal value.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.